シナリオエディタ
このページでは、ボイスボットの自動応答フロー（シナリオ）の編集を行います。
基本操作
シナリオエディタは、フローを描く「キャンバス」と、ノードを提供する「サイドバー」、詳細を設定する「パネル」で構成されています。
| 操作 | 説明 |
| キャンバス操作 | マウスのドラッグで移動、ホイールで拡大・縮小が可能です。 |
| ノードの追加 | 画面右側の「ノード追加」パレットから、使いたいパーツをキャンバスへ ドラッグ＆ドロップ します。 |
| ノードの削除 | キーボード（Delete / Backspace）によるノードの削除が可能です。 |
| ノードの接続 | 各パーツの右側にある ●（出力）から、次に進みたいパーツの左側にある ●（入力）へ線を引きます。 |
| 初期ノードの設定 | 電話が繋がって最初に動くパーツを選択し、設定パネルで 「初期ノード (Start) に設定」 をONにします。 |
| ミニマップの閲覧 | シナリオエディタの参照している位置を確認します。 |
「下書き（Draft）」と「稼働中（Active）」の2つのモード
本システムでは、「編集中の内容」と「実際に動いている内容」を完全に分けて管理します。
- 下書きモード
自由にフローを編集・保存できます。編集内容は適宜、画面右上の 「下書きを保存」 で保存してください。
未保存の変更がある場合は、オレンジ色のドットで通知されます。
- 稼働中モード
読み取り専用で現在の本番設定を表示します。ここから分析ヒートマップを重ねて表示することが可能です。
バージョンを作成する
下書きモードでフローが完成しましたら、 画面右上の「バージョン作成」 をクリックします。
- 「v1.0」などの名前と、変更内容のメモを入力します。
- この時点ではまだ本番環境には反映されません。
本番環境へ適用する
特定のバージョンを選択し、本番環境へ「適用（Activate）」します。
- 画面右上の 「履歴・復元」 ボタン（時計アイコン）をクリックします。
- 適用したいバージョンの 「復元・適用」 をクリックします。
- 即座に指定したバージョンのシナリオに切り替わります。
ノードの配置・編集
- ノード未選択時：
FlowSidebar（ノードのパーツリスト）を表示します。
- ノード選択時：
NodeEditPanel（ノードの詳細設定）を表示します。
ノード一覧
シナリオ作成に使用できる各パーツ（ノード）の役割を確認できます。
| ノード名 | 主な役割 |
| 質問する | ユーザーに問いかけ、その回答（音声）を認識してデータとして取得します。 |
| 案内する | ユーザーにメッセージを伝えます（例：挨拶や注意事項の読み上げ）。 |
| 条件分岐 | 変数の値などに応じて、次に進むルートを枝分かれさせます。 |
| システム連携 | 外部APIを呼び出し、顧客情報の参照や予約データの保存などを行います。 |
| 値を記憶 | 計算結果や特定のステータスを、変数として一時保存します。 |
| 転送 | 外線やオペレーターへ電話を転送します。 |
| 切断 | 「ありがとうございました」などの案内の後、通話を終了します。 |
UI・操作仕様のポイント
- 配置方法
サイドバーからキャンバスへドラッグ＆ドロップすることで、ノードを直感的に追加できます。 - 省スペース設計
サイドバーは開閉可能です。キャンバスを広く使いたい場合は折りたたみ、アイコンのみ（「ノード追加」ボタン）で表示できます。 - 視認性
各ノードは色分け（青・緑・黄・赤など）されており、フローが複雑になっても役割を一目で判別できます。
ノードの設定
ノードを選択することで、ノードの設定を編集することができます。
詳細につきましては、以下を確認してください。
ノードの外観とステータス表示
キャンバス上のノードを見るだけで、以下の情報を確認できます。
- 開始地点
ノードの右上に [START] というバッジが表示されている場合、 そのノードが電話接続後に最初に実行される処理です。
- 接続ポート
左側の丸（入力）から右側の丸（出力）へ線を接続することでフローを作成します。
※「電話を切る」ノードには出力ポートがありません。
- 設定の簡略表示
ノードカード内には「発話テキストの一部」「保存先の変数名」「接続先URL」などが簡略表示されます。 サイドパネルを開かなくても、フローの流れを確認できます。
- ツールチップによる詳細確認
ノードにマウスカーソルを合わせる（ホバーする）と、 Webhookのメソッドや、AIへの変換指示（プロンプト）の全文などがポップアップで表示されます。
ノードの線の色と種類
接続されている線の色を見るだけで、どのような条件で次のステップへ進むのかを判別できます。
| 線の見た目 | ラベル | 意味 |
| グレーの点線 | Default | 条件に合致しなかった場合に最後に進む「デフォルトルート」です。 |
| 緑色の線 | Yes | ユーザーが「はい」など肯定的な回答をした場合に進むルートです。 |
| 赤色の線 | No | ユーザーが「いいえ」など否定的な回答をした場合に進むルートです。 |
| 紫色の線 | Cond. | 特定の変数やカスタムロジックによる分岐条件が設定されています。 |
分岐の優先順位（Priority）
1つのノードから複数の線が出ている場合、どの条件を優先的に判定するかを示す数字が表示されます。
- ラベルの左側にある黒い丸数字が 「優先順位」 です。
- 数字が小さいほど先に判定され、条件に合致した時点でそのルートへ進みます。
条件のクイック確認（ホバー・削除）
- マウスホバー
線の中央にあるラベルへマウスカーソルを合わせると、設定されている具体的な条件式 （例：vars.age >= 20など）がポップアップで表示されます。 - 削除
ラベル部分にマウスを合わせると表示される[x]アイコン、 または線を選択して削除キーを押すことで接続を解除できます。
分析ヒートマップ（ヒートマップモード）
各ノードに離脱数や成果数などの統計情報をオーバーレイ表示する機能です。
稼働中モードで「分析ヒートマップ」をONにすると、 各ノードの状態が色付きの枠やバッジで表示されます。
| 表示の変化 | 意味 | ユーザーが取るべきアクション |
| 緑色の太枠 + [CV] バッジ |
成果（予約完了など）に繋がったノード | 成功パターンのため、維持または他のフロー改善の参考にします。 |
| 赤色の太枠 + [Drop] バッジ |
離脱率が高い（30%以上）要注意ノード | ユーザーが困っている可能性が高いため、発話内容やフローの見直しを検討します。 |
| 橙色の太枠 + [Drop] バッジ |
離脱が発生しているノード | 定期的に確認し、改善の余地がないかチェックします。 |
| 青色の太枠 + [End] バッジ |
通常の通話終了が発生したノード | 意図した終了ポイントかどうかを確認します。 |
- ツールチップによる詳細確認
ノードにマウスカーソルを合わせる（ホバーする）と、直近7日間の終了内訳（完了・離脱・失敗・CV）をカラーバーで確認できます。
